home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / vd115r.zip / VD.DOC < prev    next >
Text File  |  1990-11-04  |  28KB  |  764 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                  ValidOOR
  9.                                  --------
  10.  
  11.  
  12.  
  13.                         Version 1.10 Documentation
  14.                         --------------------------
  15.  
  16.  
  17.  
  18.        Copyright (c)1989-90, Cabell B. Clarke Jr., All Rights Reserved.
  19.  
  20.  
  21.                            The Boot Factory BBS
  22.                            --------------------
  23.                              FidoNET 1:264/19
  24.                               3/12/24/96HST
  25.                               804-262-9289
  26.  
  27.  
  28.  
  29. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  30.  
  31.  
  32. Disclaimer
  33. ----------
  34.  
  35. This software is sold "AS IS".  It is not guaranteed to work at all. If
  36. it trashes your system or ruins your life, you have been warned.  I am
  37. not responsible for any damages incurred from the use or misuse of this
  38. software.
  39.  
  40.  
  41.  
  42. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  43.  
  44.  
  45.  
  46.  
  47. ValidOOR is a User Validation Door written for QuickBBS and Remote
  48. Access Bulletin Board Systems.  ValidOOR allows Sysops to have their
  49. systems call users back in order to verify that they have left a valid
  50. phone number for the sysop's records.  This results in a more secure
  51. system for the sysop as well as his users.
  52.  
  53. ValidOOR is being released as Shareware.  This means you are free to
  54. evaluate the program for 30 days.  If it meets your needs, you are
  55. then expected to register your copy by sending me a registration fee.
  56. Registering ValidOOR entitles you to all minor releases of Version 1
  57. of ValidOOR (1.00-1.99).  It also grants you access to the ValidOOR
  58. Support Forum on my BBS which contains files, etc which are related
  59. to ValidOOR, such as the soon to be available VD_Util which is a
  60. program to maintain your vd.cfg file as well as your User Directory.
  61. There will not be a version 2.00 of ValidOOR before September of 1990.
  62.  
  63. Unregistered versions of ValidOOR will have a 30 second delay built-in
  64. to the program.  The KEY file will eliminate this delay and inform
  65. the rest of the world that you have registered your copy.
  66.  
  67. Please register ValidOOR.  This program has taken me over 19 months
  68. to write and debug, and has cost me a lot in the process.  Support
  69. the Shareware concept.  Registration of ValidOOR allows you to run
  70. ValidOOR on one computer system.
  71.  
  72.  
  73. In order to register ValidOOR, see the LICENSE.DOC file for an order
  74. entry blank.  Fill out the form and send with the registration fee to
  75.  
  76.                 Cabell Clarke
  77.                 5513 Cottage St.
  78.                 Richmond, VA   23228
  79.  
  80. Your KEY file will be sent to you via FidoNet mail, or US Mail
  81. whichever is convenient.  Allow 2 weeks for processing.
  82.  
  83.  
  84. A Note to Remote Access Users
  85. -----------------------------
  86.  
  87. At this time, VD does not support file/record locking so it cannot be
  88. reliably used on a multi-node bbs on more than one node.  It should
  89. work fine on one node however.  I would like to add file/record
  90. locking to VD in the future.  Send Code<tm>.
  91.  
  92.  
  93.  
  94. Getting Started
  95. ---------------
  96. The Archive contains the following files:
  97.  
  98. VDnnn.EXE         - ValidOOR Executable Program (nnn=version)
  99. VD.CFG            - ValidOOR Configuration file.
  100. VD.DOC            - ValidOOR Documentation
  101. VALIDATE.BAT      - Batch file that I use to call ValidOOR
  102. RUNRA.BAT         - My system batch file showing how I call Validate.Bat
  103. TOP.MNU           - My QuickBBS TOP.MNU menu
  104. VALIDOOR.MNU      - QuickBBS Menu that I call ValidOOR from.
  105. INVALDGB.ASC      - One of my text files defined in vd.cfg
  106. VALIDGB.ASC       - One of my text files defined in vd.cfg
  107. LDGOODBY.ASC      - One of my text files defined in vd.cfg
  108. REGISTER.ASC      - One of my text files called from Validoor.Mnu
  109. LICENSE.DOC       - An order form to register ValidOOR
  110. RELEASE.DOC       - Release Notes
  111.  
  112. ValidOOR is compressed using PKZIP and the Authenticity Verification
  113. option.  My number is LZF378 and this number will appear in the
  114. ZIPchive when you unzip it.
  115.  
  116.  
  117. In order to get going with VD, first you need to unARC all of the files
  118. into your BBS directory.  I recommend printing this documentation as
  119. well as the VD.CFG file as it contains helpful hints for setting up
  120. the config file in it's comments.
  121.  
  122. Modify (or create) the .MNU .ASC .BAT files included to your needs.
  123. The enclosed are samples only which I run on my system.
  124.  
  125. Rename the vd###.exe to VD.EXE
  126.  
  127.  
  128.  
  129.  
  130. vd.cfg
  131. ------
  132. The VD.CFG file contains all of the important parameters necessary to
  133. run VD.  Please remember that any line which begins with a per-cent (%)
  134. is a comment and may be removed, however, if you remove comments, you
  135. are on your own.  VD.CFG is well-commented and should be self explanatory
  136. in setting it up.  Just load it into your text editor.  Make sure that
  137. there are no comments on the lines which contain parameters.  Also make
  138. sure that you only have one (1) space between the Variable Descriptor and
  139. the variable itself like this:
  140.  
  141.  
  142. ModemSuffix &M4
  143.            ^
  144.            |
  145.            one space here
  146.  
  147. NOTE:  In the beta versions there have been several vd.cfg file formats.
  148.        In v1.00, there are some new descriptors so it is suggested that
  149.        you modify the config file included in this archive to suit your
  150.        setup.
  151.  
  152.        Make sure the vd.cfg file you are using is compatible with your
  153.        version of VD.
  154.  
  155.  
  156.  
  157. Variable descriptors in vd.cfg
  158. ------------------------------
  159.  
  160. %               - the percent sign is a comment and must be placed in the
  161.                   first column of the line that you wish VD to ignore.
  162.                   Do not place a '%' on the same line after a variable
  163.                   descriptor or the program will blow up.
  164.  
  165.  
  166. SysopName       - Your name should go here in the same format as you
  167.                   register VD in.  Example:
  168.  
  169.                 SysopName Cabell Clarke
  170.  
  171.  
  172. SysName1        - One line of text which may be used to describe your
  173.                   system.  SysName1 is displayed first.  Mine looks like
  174.                   this:
  175.  
  176.                 SysName1 Boot Factory BBS - FidoNet 1:264/19
  177.  
  178.  
  179. SysName2        - Another line of text for more info about your system.
  180.                   SysName2 is displayed after SysName1.
  181.  
  182.  
  183.  
  184. Port            - Port tells VD which comm port you are using.  Valid
  185.                   ports are 0-3 where port 0 = COM1 etc.  If you are
  186.                   using COM1 for your modem you would need:
  187.  
  188.                 Port 0
  189.  
  190. DialPrefix      - This is the prefix that tells your modem how to dial
  191.                   out.  Mine looks like this:
  192.  
  193.                 DialPrefix ATDT
  194.  
  195.  
  196. QuickPhone      - This variable is used to tell VD how your QuickBBS
  197.                   saves the user's phone number.  When a new user logs
  198.                   on if you ask for both Home Phone Number and Data
  199.                   /Business Phone number then your VD.CFG file would need
  200.                   the following:
  201.  
  202.                 QuickPhone HomePhone
  203.                 QuickPhone DataPhone
  204.  
  205.                   If you only ask them for their Home Phone Number than
  206.                   your VD.CFG file would only need this:
  207.  
  208.                 QuickPhone HomePhone
  209.  
  210.  
  211. AreaCode        - This Variable is used to tell VD which area code(s)
  212.                   you can place a local call to.  You may have up to
  213.                   5 local area codes in VD.CFG...  for instance someone
  214.                   who lives in Washington DC might have a VD.CFG which
  215.                   looks like this:
  216.  
  217.                 AreaCode 202     <-- your area code first
  218.                 AreaCode 301
  219.                 AreaCode 703
  220.  
  221.                   This is because he does not need to use an area code
  222.                   to dial any of these three areas.  Maximum of 5 local
  223.                   area codes supported at this time. Make sure that your
  224.                   own area code is listed in the file first.
  225.  
  226.  
  227. LongDistance    - The LongDistance enables/disables Long Distance calling.
  228.                   If you do not want VD to make a long distance call you
  229.                   would have the following in your VD.CFG file:
  230.  
  231.                 LongDistance NoLDCall
  232.  
  233.                   If you didn't care if VD made a Long Distance call or
  234.                   not, you would use:
  235.  
  236.                 LongDistance LDCall
  237.  
  238.  
  239.  
  240. LDStart         - These are the descriptors to force ValidOOR
  241. LDStop            to call only during a slot of time.  Example:
  242.  
  243.                 LDStart 2300
  244.                 LDStop 0700
  245.  
  246.                   would cause ValidOOR to only validate long distance
  247.                   callers between the hours of 11 pm and 7 am.  If you
  248.                   set the LongDistance descriptor to NoLDCall, these two
  249.                   descriptors will be ignored by VD.  If you decide you
  250.                   do not want to use a slot just comment them both out.
  251.                   ** DO NOT USE ONE WITHOUT THE OTHER **
  252.  
  253.  
  254. MaxAttempts     - This variable tells VD how many times to attempt to
  255.                   call a user with NO CONNECT!  If you only wanted to try
  256.                   twice you'd have:
  257.  
  258.                 MaxAttempts 2
  259.  
  260.                   VD will only call once if a connection is made.  This
  261.                   is hard-coded into the program and cannot be modified.
  262.  
  263. ModemTimeOut    - This is the number of seconds you want VD to wait for a
  264.                   carrier before recycling.  NOTE:  For maximum efficiency
  265.                   You should also set this value in register S7 of your
  266.                   modem in your modem initialization string. (S7=45). See
  267.                   ModemInit below.
  268.  
  269.                 ModemTimeOut 45
  270.  
  271.  
  272. UserTimeOut     - This is the number of seconds to wait for input from
  273.                   the user before timing out due to INACTIVITY.
  274.  
  275.                 UserTimeOut 40
  276.  
  277.  
  278. YourCitySt      - Tells VD what city and state your BBS resides in to
  279.                   notify the user where the call will be originating
  280.                   so the user can tell VD if VD needs to dial a 1 to
  281.                   reach the User.
  282.  
  283.  
  284.  
  285. ModemInit       - This is the string that you want VD to use to initialize
  286.                   your modem.  I use this for my HST:
  287.  
  288.                 ModemInit AT S0=0 E0 X6 S7=45|
  289.  
  290.                   Note the s7=45 which is the same as the 45 in the
  291.                   ModemTimeOut variable above.  If you want VD to ignore
  292.                   result codes use an X0 in this string but remember
  293.                   if you use an X0, all Bad Number/VOICE connect
  294.                   processing will be eliminated.  The "|" character adds
  295.                   a carriage return to your string.
  296.  
  297.  
  298. ModemReset      - This variable tells VD whether you want to reset your
  299.                   modem before you initialize it.  If you want to reset
  300.                   it enter the string you want to send to it like this:
  301.  
  302.                 ModemReset ATZ|
  303.  
  304.                   If you do not want VD to reset your modem first then
  305.                   use:
  306.  
  307.                 ModemReset NoATZ
  308.  
  309.  
  310.  
  311. LogPath         - This is the path to your VD Log File where a log
  312.                   of VD's activities are kept.  I use:
  313.  
  314.                 LogPath d:\qbbs\validoor.log
  315.  
  316. ExitInfoPath    - *NEW IN 1.10* - another optional descriptor which
  317.                   tells your VD where it can find your EXITINFO.BBS
  318.                   file.  Default is current directory.
  319.  
  320.  
  321. UserDir         - This is the Path to your User Directory where the
  322.                   names and phone numbers of validated users are
  323.                   stored.  This is to make sure that users cannot
  324.                   be validated twice at the same phone number. I use:
  325.  
  326.                 UserDir d:\qbbs\validoor.dir
  327.  
  328.                   This is an optional feature and may be disabled by
  329.                   commenting it out like this:
  330.  
  331.                 % UserDir d:\qbbs\validoor.dir
  332.  
  333.  
  334.  
  335. BadNumber       - This is the Path to your Bad Phone Number Control
  336.                   File.  This file is where any phone numbers that
  337.                   ValidOOR senses to be VOICE connects will be written
  338.                   and therefore prevented from ever being dialed by
  339.                   ValidOOR again.  If you wish you may use your
  340.                   BBS PHONENUM.CTL file for this, remembering
  341.                   that any numbers that end up in PHONENUM.CTL will
  342.                   be forever barred by the BBS.  Usage as follows:
  343.  
  344.                 BadNumber d:\qbbs\badnumbr.ctl
  345.  
  346.                   or maybe:
  347.  
  348.                 BadNumber d:\qbbs\phonenum.ctl
  349.  
  350.                   If you do not wish to use this feature, simply
  351.                   comment it out.  It is optional.
  352.  
  353.  
  354. ModemSuffix     - This is for modems like the HST which can use a suffix
  355.                   after the phone number to cause a certain type of
  356.                   connection to be made.  With my HST I use:
  357.  
  358.                 ModemSuffix &M4
  359.  
  360.                   This causes the HST to attempt an ARQ connection first
  361.                   and then in case of failure, drop back to a regular
  362.                   connection.  If you don't want to use a suffix. use
  363.                   the following:
  364.  
  365.                 ModemSuffix -
  366.  
  367.                   The '-' character will be ignored by your modem.
  368.  
  369.  
  370. WaitTime        - This is the number of seconds to wait before the first
  371.                   attempted call and between each attempted call.  I
  372.                   suggest using 10 seconds:
  373.  
  374.                 WaitTime 10
  375.  
  376.  
  377. OffHook         - This is the string you wish to use to take your modem
  378.                   offhook during the above WaitTime to keep an incoming
  379.                   call from messing up VD's validation attempt.  I use
  380.                   this for my HST:
  381.  
  382.                 OffHook ATH1
  383.  
  384.  
  385.  
  386. OnHook          - This string puts the modem back on hook after WaitTime
  387.                   before a call is made.  I use:
  388.  
  389.                 OnHook ATH0
  390.  
  391.  
  392. ValidGoodbye    - This is the path to a text file that you wish to be
  393.                   displayed to the user who has been validated
  394.                   successfully.  I use:
  395.  
  396.                 ValidGoodbye d:\qbbs\text\validgb.asc
  397.  
  398. InValidGoodBye  - This is the path to a text file to be displayed to a
  399.                   user that is not validated successfully. Mine is:
  400.  
  401.                 InValidGoodbye d:\qbbs\text\invaldgb.asc
  402.  
  403.  
  404. LDGoodbye       - This file will be displayed to a user when Long Distance
  405.                   calls have been disabled. I use:
  406.  
  407.                 LDGoodbye d:\qbbs\text\ldgoodby.asc
  408.  
  409.  
  410. HitAnyKey       - This is for High-Speed modem users who run with the
  411.                   port locked.  It places a "Hit ANY Key" at the end
  412.                   of each 'goodbye' file above, so that the user will
  413.                   see all of the file before the modem disconnects.  If
  414.                   your port is not locked use:
  415.  
  416.                 HitAnyKey No
  417.  
  418.                   If your port is locked use:
  419.  
  420.                 HitAnyKey Yes
  421.  
  422.  
  423. SlowModem       - This descriptor enables commands sent to the modem
  424.                   slowly for modems that cannot respond to an init
  425.                   string sent at full blast! Use:
  426.  
  427.                 SlowModem On
  428.  
  429.                   for cheaper modems
  430.                   or
  431.  
  432.                 SlowModem Off
  433.  
  434.                   if your modem can handle the commands sent at full blast.
  435.  
  436.  
  437.  
  438. Display         - This descriptor is used to enable Direct Screen writes
  439.                   for certain portions of ValidOOR.  It should be set:
  440.  
  441.                 Display Direct
  442.  
  443.                   unless your system is not an IBM Clone and cannot handle
  444.                   direct writes.  Then you would use:
  445.  
  446.                 Display BIOS
  447.  
  448.                   Using the BIOS option disables the color options below
  449.                   and also removes the Status Line.  It allows VD to
  450.                   operate in a Bare Mode for non-clones.   If you run
  451.                   VD under desqview you should use display bios.
  452.  
  453. ForeGround      - Color Attributes for the status line and Advertisement
  454. BackGround        I use something like this:
  455.  
  456.                 ForeGround 0
  457.                 BackGround 3
  458.  
  459.                   which would be black letters on a light blue background.
  460.  
  461.                   These are not necessary in the 'Display BIOS' mode of
  462.                   operation.
  463.  
  464.  
  465. WindowBackGround  -  Color Attributes for the Window.  Again they are not
  466. WindowForeGround     used in 'Display BIOS' mode.
  467.  
  468.  
  469.  
  470. WindowFrame     - This descriptors defines the type of border you want
  471.                   on the window:
  472.  
  473.                 WindowFrame 4
  474.  
  475.                   The possible combinations for windows are:
  476.  
  477.                                    0 = No Lines
  478.                                    1 = Single Lines
  479.                                    2 = Double Lines
  480.                                    3 = Single Horiz - Double Vert
  481.                                    4 = Double Horiz - Single Vert
  482.  
  483.                   This descriptor is also not used in 'Display BIOS' mode.
  484.  
  485.  
  486.  
  487.  
  488. SecLevel        - This is the security level you want to set validated
  489.                   users to:
  490.  
  491.                 SecLevel 5
  492.  
  493.                   If you do not want Validoor to set any levels, then
  494.                   comment out this line.
  495.  
  496.  
  497. AFlag           - These descriptors define the bit masks for the user
  498. BFlag             flags. You set them just like you would in your
  499. CFlag             user editor.  If you don't want VD to mess with
  500. DFlag             user flags, just comment them out.  Using the letter
  501.                   'n' in place of any bit will cause VD to leave that
  502.                   bit untouched.
  503.  
  504.                 AFlag XXXX---n
  505.                 % BFlag --------
  506.                 CFlag X-X-X-Xn
  507.                 % DFlag --------
  508.  
  509.                   Above the AFlag and CFlag would be set like above for
  510.                   a user who passes validation successfully.  The BFlag
  511.                   and DFlag would not be touched.  Bit 8 on both AFlag
  512.                   and CFlag would be untouched by ValidOOR.
  513.  
  514. TimeLimit       - Use this to set the new time limit for the user after
  515.                   he is validated.
  516.  
  517.                 TimeLimit 60
  518.  
  519.                   would give a newly validated user 60 minutes.  This is
  520.                   useful if you let newly validated users back into your
  521.                   system after you call them (on your nickel).  Comment
  522.                   this out to disable this feature.
  523.  
  524.  
  525.  
  526. In ALL of the above descriptors the CASE is not significant but it may
  527. be in your modem commands depending on your modem.
  528.  
  529.  
  530.  
  531.  
  532.  
  533. Interfacing ValidOOR
  534. --------------------
  535. There are several ways you can run ValidOOR on your system.  I use
  536. a type 40 command in my TOP.MNU with flag D1 set ON (X) to force all
  537. new users into the validation menu.  After successful validation I
  538. set the D1 flag back off (-) and then when they hit TOP.MNU the 1st
  539. type 40 command will be ignored due to the flag not being ON and the
  540. TOP.MNU will execute normally.  I have included my menus in this
  541. archive to give you an idea as to how I do it.
  542.  
  543. You can also just use a Type 2 command to let your users access VD
  544. that way...  it is up to your personal preference as to how you
  545. get your users into ValidOOR.  Be creative :-).  That is why the
  546. system has been designed to be so open-ended.
  547.  
  548.  
  549. Once the user selects ValidOOR, QuickBBS should exit via type
  550. 15 to run ValidOOR.  I use type 15 with a batch file which I have
  551. included here.  In order for ValidOOR to properly update a user's
  552. security level, it must be run from a type 15.  This is a major
  553. difference from earlier versions of ValidOOR.  If you don't want
  554. ValidOOR to update user security levels or flags, you may run it
  555. from a Type 7 exit and it will work fine provided you have enough
  556. memory.
  557.  
  558. ValidOOR loads, initializes the FOSSIL driver, and does some setup
  559. things - reads VD.CFG which you the user must set up, and then it
  560. looks for EXITINFO.BBS.
  561.  
  562. ValidOOR also display a logo on the top four lines of your monitor
  563. using color and windows in the Display Direct mode.  A status line is
  564. displayed at the bottom of the screen in Display Direct mode which
  565. contains the following info:
  566.  
  567.  
  568.  
  569. User Name                  City, ST       Baud Rate      U:[Yes|No]
  570.  
  571.  
  572.  
  573. The first three items are self-explanatory.  The fourth item (U:) is
  574. the Update flag which tells you whether VD is set up to automatically
  575. upgrade a users security level or not.
  576.  
  577. At this point, if you have opted to use a User Directory File to
  578. prevent duplicate phone numbers, VD will check for the existance of
  579. this file which it creates if not found.  If you comment out the
  580. UserDir descriptor in VD.Cfg, no dupe checking will be performed.
  581.  
  582. ValidOOR also creates a log file and appends info to it so you can
  583. keep track of it's activities.
  584.  
  585.  
  586.  
  587. ValidOOR can be set up to use either the business/data phone number,
  588. the home/voice phone number or both phone numbers that the user entered
  589. during his initial login depending on how you choose to set up your
  590. QuickBBS.  It will prompt the user to select which of the two numbers
  591. his modem is currently connected to and give him an option to abort the
  592. process should he so desire.  After this selection is made, ValidOOR will
  593. ask him if a 1- should be placed in front of the number for a long distance
  594. call.  If you choose not to let VD make long distance calls, the user will
  595. not be called and a file explaining the situation can be displayed (See
  596. VD.CFG descriptor LDGoodbye.  If Long distance calling is enabled, VD
  597. will place the 1- in front of his number and continue with the process.
  598.  
  599. If all files are present and everything went properly, ValidOOR will inform
  600. the user that he is about to be validated and display the following:
  601.  
  602. Prepare for an incoming call.  If your modem will not auto answer, when
  603. you see the RING on screen type ATA <Enter>.
  604.  
  605. Then ValidOOR prompts him to hit <ENTER> when he is ready to begin.
  606. When the user hits <ENTER> ValidOOR will disconnect him, take the phone
  607. off the hook, and wait a pre-defined number of seconds (WaitTime in
  608. VD.CFG).  The ValidOOR will put the modem back on the hook and call the
  609. user at the same baud rate that he used to log into the BBS. The number
  610. of "Non-Connect" attempts can be set up in VD.CFG but the system, after one
  611. connection is made, will not make another attempt to call.
  612.  
  613. If you modem is capable of sensing a VOICE connect, and your modem
  614. init string has the proper value sent to it to enable this feature, then
  615. when ValidOOR senses a VOICE connection and you have a path in the
  616. 'BadNumber' descriptor uncommented, ValidOOR will abort and write this
  617. phone number to a BadNumber Control file.  Then VD will never attempt
  618. to call this number again.  You may use your PHONENUM.CTL file in
  619. QuickBBS for this if you fully understand that no one ever be able to
  620. use this number to log in to your BBS as a new user again. Using X0 in
  621. your Modem Init string will totally disable modem result codes and
  622. then ValidOOR will ignore all of this entirely.
  623.  
  624. When the connection is successful, ValidOOR will display a brief message
  625. something like this:
  626.  
  627. ValidOOR v1.00
  628.  
  629. and then display the SysName1 and SysName2 messages that you set up in
  630. VD.CFG.  Next VD prompts the user to enter his password.  He gets three
  631. tries before ValidOOR gives up and disconnects.  An Inactivity timer
  632. which is configurable in VD.CFG will disconnect him if he falls asleep.
  633.  
  634. If he fails to enter the proper password (from EXITINFO.BBS) for whatever
  635. reason, the system will disconnect him and exit with an errorlevel 2. Your
  636. batch file can then process the errorlevel accordingly.  An appropriate
  637. entry will be written to the log.
  638.  
  639.  
  640. If he is successful, then ValidOOR will exit with an errorlevel 0.  Your
  641. batch file can process accordingly.  Also an entry will be written into
  642. the log file to let you know what happened.  If you have selected to do
  643. so in VD.CFG, and are running from a type 15 exit, ValidOOR will update
  644. the user's security and user flags in the EXITINFO.BBS --
  645.  
  646. *** NOTE:  It is necessary to reload your BBS after VD exits using the
  647.            command:
  648.  
  649. QUICKBBS -R
  650. or
  651. RA -R
  652.  
  653.        in order for the changes in security level and user flags to
  654.        take place.  If you do not reload your BBS the updates will NOT
  655.        be written to the USERS.BBS file.  See my RUNRA.BAT file included
  656.        for an exact example as to how this should be done.
  657.  
  658. Local Mode
  659. ----------
  660.  
  661. ValidOOR has a Local Mode that a sysop can use for testing purposes.  You
  662. must exit (type 15 or 7) from QuickBBS (in local) for it to work.  VD can
  663. tell from Exitinfo.Bbs that you are in LOCAL mode and will react accordingly.
  664. While in Local mode, VD will not check to see if the phone number exists
  665. in the User Directory file.  This will allow you to test as many times as
  666. you like without having to delete yourself from the User Directory every
  667. time.
  668.  
  669. In local mode, VD will skip the dialing and jump straight to Connection
  670. and attempt to validate you.  Your phone number will be written into the
  671. User Directory if you pass the validation.
  672.  
  673.  
  674.  
  675.  
  676. ERRORLEVELS
  677. -----------
  678.  
  679. Several cases will cause ValidOOR to abort with an errorlevel:
  680.  
  681.         o  absence of any of these files:               errorlevel=1
  682.                 EXITINFO.BBS
  683.                 VD.CFG
  684.  
  685.         o  User Not Validated                           errorlevel=2
  686.  
  687.         o  SysopName missing in VD.CFG                  errorlevel=3
  688.  
  689.         o  Duplicate Phone Number (in directory file)   errorlevel=4
  690.  
  691.         o  User Abort at Menu                           errorlevel=5
  692.  
  693.         o  Absence of FOSSIL Comm Driver                errorlevel=6
  694.  
  695.         o  Long Distance attempt (if enabled):          errorlevel=7
  696.  
  697.         o  Inactivity                                   errorlevel=8
  698.  
  699.         o  Carrier Loss:                                errorlevel=9
  700.  
  701.         o  VOICE connect detection                      errorlevel=10
  702.  
  703.         o  Bad Number detected (BadNumber Control File) errorlevel=11
  704.  
  705.         o  Bad KEY file                                 errorlevel=12
  706.  
  707. If the user is validated successfully, ValidOOR will exit with an
  708. errorlevel of 0.
  709.  
  710. These errorlevels are enabled in this release.
  711. They are not guaranteed to remain the same in future versions.
  712.  
  713. You can take advantage of these errorlevels by trapping them all in your
  714. batch file and using the traps to generate entries in your log to give
  715. you a more verbose explanation of what went on....  be creative.  You
  716. can use them any way you like.
  717.  
  718. If ValidOOR aborts, an entry will be written into the log to inform you
  719. what happened.
  720.  
  721.  
  722.  
  723. VALIDOOR.KEY
  724. ------------
  725. The ValidOOR Key file eliminates the 30 second delay at the beginning of
  726. the program.  You must register ValidOOR in order to get a key from me.
  727. I can send the key via FidoNet mail or US Mail (Snail Mail).  Please
  728. specify which method you prefer when registering ValidOOR.
  729.  
  730.  
  731. %%%%%%%%%%%%%
  732.  
  733.  
  734.  
  735.  
  736.  
  737. Credits
  738. -------
  739.  
  740. Thanks to the following individuals:
  741.  
  742. Adam Hudson           -  The Original Author of QuickBBS.
  743. Continental Software  -  The Remote Access folks.
  744. Robert Rosanio        -  who gave me the original idea.
  745. Greg Dawson           -  for teaching me how to access FOSSIL.
  746. Mike Janke            -  for his wonderful Exit w/errorlevel code.
  747. Rob Fletcher          -  for writing SetFlag.
  748. Jim Whitby            -  for Documentation and other Help.
  749. Ed Greene             -  for his debugging help and reports.
  750. Richard Alfoni        -  for his debugging help and reports.
  751.  
  752.  
  753. Also Thanks to the Beta Testers....  All of you.
  754.  
  755.  
  756. Report ALL to:
  757. Cabell Clarke
  758. 804-262-9289 DATA
  759. 1:264/19
  760.  
  761.  
  762.  
  763. 
  764.